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RS-232 COMMUNICATIONS 
HOST COMMUNICATION 


Communication between the 222 and an external host compuier is 
provided via an RS-232 communications interface. The aciual format 
of ihe commands is as Close to the Tek Codes and Formats as possi- 
ble with the limited memory space available. Ceriain functions are 
compressed into a more compact form. 


Waveforms and front-panel settings may be transferred over ihe 
RS-232 serial port in ascii character strings. The optional demon- 
stration disk accessory (available by request only) supports commu- 


nications with an IBM® PC or PC compatible computer. Operating 


details are provided on the disk in a “README?” file. 


A simple terminal can be used to receive the messages that may be 
generated at power on or during self calibration if an error occurs. The 
error codes are defined later In this manual. An RS-232 intercon- 
nection cable for use with the 222 is available as an optional acces- 


sory. The cable wiring diagram is shown in Figure 1. Setting the 


communication baud rate for the 222 is done using menu selections 
available in the Auxiliary Functions menu under CONFIG. 


RS-232 Interface Specifications 


Maximum Applied Voltage (any pin) va En ae € a Ge nies zh 


25 V (de + peak ac). 
Baud Rates 


300, 1200, 2400, 9600; 0.1% accuracy based one miro ee 


processor clock, 
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Figure 1. RS-232 interconnection cable wiring. 


RS-232 Optional Accessories 


Demonstration Disk 063-0070-00 
RS-232 Interconnection Cable 175-1453-00 


Codes and Formats 


Commands, front panel setups, and waveforms sent over the RS-232 
interface are composed of ascii character strings. The ascii charac- 
ters represent hexadecimal numbers, with two characters per hexa- 
decimal value. 


The general command format is as follows: 


cmd arg:data; 









1S 1S 








pa 


S 

argumeni. 7 
command terminator, butitisn 
is given in a command line. 
started execution by sending 


Commands 


The following commands are supported. 





BUT <button> Simulates a button press 
CURV? <frame> Request waveform data 
The waveform data is sent 


as hex encoded ascii 
characters. <frame> 
is one of seven possible 


ources for curve data 





CURV <frame>:<wfrm data> Loads waveform data into 
the 222. The data must be 
sent as hex encoded ascii 
characters 


ID? Queries instrument ID and 
software version. 


TRG? Queries the trigger state. 


STA? Queries the communi 
cation task status. 


DAC? <dac code> Queries a dac value 
<dac code> is one 
of eight dacs (digital-to- 
analog converters) for 
digitized potentiometer 
settings. 


DAC <dac code>:<dacvalue> Sets a dac value. 


—sasaattt 








Se 
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FP? <log fp> 


FP <log fp>:<fp data> 


Queries a front panel 
setup. <log fp > is one of 
nine possible front-panel 
data locations. 


Sends a front panel setup 
to the <log fp > location. 


Argument and Data Definitions 


Arguments to cornmands and data strings are defined as follows: 


<button> is one or two ASCII characters that represent a 
button code. The button codes are as follows: 


MOQOWPCOOAMAAWDND = 


CLEAR 

Menu Item 0 
Menu Item 1 
Menu Item 2 
Menu Item 3 
OFF 

Trigger SOURCE 
Trigger MODE 
Trigger SLOPE 
CH 2 Select 

CH 1 Select 
AUTO SETUP 
Front-Panel Setup Ment 
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The following command string is a simple example of how to use the 
BUT command to change a front panel setting controlled by button 
pushes. | 


BUT 9;BUT 2 


calls up the Trigger SOURCE menu then selecis menu item 0, the first 

“menu choice (VERT). Notice the semicolon delimiter is not needed at 
the end of the command string terminated by a carriage return, only 
between commands in the string. 


<frame > is one of the following strings: 


RO Readout. 

CH1 Channel 1. 

CH2 Channel 2. 

REF1 Reference waveform 1. 
REF2 Reference waveform 2. 
REF3 Reference waveform 3. 
REF4 Reference waveform 4. — 


<wfrm data> = ote data> <frame nr> — 
<byte count> <waveform data> <sheckeumn> ; 
defined as follows: 


<fp data > resi characters repr 








<frame nr> 
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<waveform data> In YT mode, each data point is 
the hexadecimal value 
(represented by two ascii 


characters) of the Y-coordinate. 


In XY mode, the X- and 
Y-coordinates are sent as two 
hexadecimal values (represented 
by four ascii characters) with the 
X-coordinate value first, followed 
by the Y-coordinate value. 


<checksum> Two ascii characters representing 
the hexadecimal twos complement 
of the modulo 256 checksum of all 
data bytes, the byte count bytes, 


and the mode byte. 
Programmers take note, additional bytes may be added to the data 


string after the checksum byte. This space is reserved for future 
expansion. 


<dac code> = Two digit hex code that identifies the dac. 


00 Horizontal Position (0000-0400) 
01 Channel 1 Trigger Level (0000-1 FFF) 
02 Channel 2 Trigger Level (0000-1 FFF) 
03 External Trigger Level (0000-1 FFF) 
04 Channel 2 Variable Gain (0000-03FF) 
05 Channel 1 Variable Gain (0000-O3FF) 
06 Channel 2 Position (0000-1 FFF) 
07 Channel 1 Position (0000-1 FFF) 


<dac value> = Four digit hex code for the dac value. The 
_ ranges of possible values are shown in parenthesis above. 
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<log fp > is one of the following: 


ACQ Acquisition system 
REF1 Reference waveform 1 
REF2 Reference waveform 2 
REF3 Reference waveform 3 
REF4 Reference waveiorm 4 
STR1 Front panel setup 1 
STR2 Front panel setup 2 
STR3 Front panel setup 3 
STR4 Front panel setup 4 


<fp data> is the 10 ASCII characters that represent the five, 
2-character hexadecimal bytes of a logical front panel setup. A 
front panel query of the acquisition settings (FP? ACQ) returns 
data In the following format: 


FP ACQ:24240C2112; 


The byte decoding (by bit) for the front panel settings is given in 
Tables 1 through 5, with each table showing the decoding for 
one of the hexadecimal bytes. 


VERTICAL SETTINGS. From Table 1 and Table 2 you can decode 
the bits for the CH 1 and CH 2 vertical settings. In the example setup 
data string, the first four characters are: 2424. Breaking these num- 
bers into binary bits, a 2 gives 0010, and a 4 gives 0100. Looking at 
the bit information for the first character tells us that INVERT is OFF, 
VAR is OFF, and the input coupling is GND. Forthe second character, 
its bit values are given, but looking at the HEX value column tells us 
that the VOLTS/DIV setting is 0.1 V per division. Since exactly the 
same values are given for characters 3 and 4 as 1 and 2respectively, 
the CH 2 settings are therefore the same as the CH 1 settings. 


To change the VOLTS/DIV setting for CH 1 to 1 V, change the value of 
character 2 from 4 to 7 in the front panel setup string when it is sent 
back to the oscilloscope. The string sent back then is: 


FP ACQ:27240C2112 : 








=a 
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Notice that a semicolon delimiter is needed only if further commands 
are included in the string. The command Is executed as soon as the 
last character of the command is sent; multiple commands in a string 
are executed as they are recognized. 


SEC/DIV SETTING. Characters 5 and 6 (Table 3) from the example 
string are 0 and C. In binary bits, these characters are 0000 and 1100 
respectively. You can see from Table 3 that the bits of character 5 
define several settings of the front panel. The example bit values of 
0000 decode to show that the READOUT OFF menu choice is OFF 
(not selected, so the readout is on), XY display mode is OFF, and X10 
MAG is OFF. 


The fourth bit of character 5 is assigned to the SEC/DIV settings along 
with all four bits of character 6. A bit value of 0 for this bit defines SEC/ 
DIV settings of § ms and faster. A bit value of 1 defines SEC/DIV set- 
tings of 10 ms and slower.The four bits of character 6 are all used to 
define the SEC/DIV setting. For the example then, the SEC/DIV setting 
is below 10 ms (0 value of bit 4 of character 5), and the 1100 (hex C) 
value of character 6 gives a SEC/DIV seiting of 0.5 ms per division. 


Then, to change the SEC/DIV setting to 0.1 ms for example, just 
change character 6 from C to B. However to change to 20 ms, the 
value of character 5 will also have to change, with it going from 0 to 1 
in the front panel setup string while character 6 changes to a 1. 


TRIG POS, SLOPE, SOURCE, AND MODE SETTINGS. Characters 
7 and 8 (Table 4) of the front panel setup string define several of the 
trigger settings of the instrument. Two bit values of the two characters 
are used to define the Trig SOURCE setting (bit 4 of character 7 and 
bit 1 of character 8). Therefore, both characters must be set correctly 
to control the Trigger SOURCE setting. 


In our example front panel setup string, characters 7 and 8 are 2 and 1 
y. The binary bits are therefore 0010 and 0001 for these 


two characters, The first two bits of character 7 define the TRIG POS 
3 oe ft values of 00 in these positions decode to a TRIG POS 





| 
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The last bit of character 7 and the first bit of character 8 are 0 and 0 
respectively and decode to VERT Trigger SOURCE. The last three 
bits of character 8 are 001 and decode to AUTO LVL Trigger MODE. 


ACQUISITION MODE AND MISC SETTINGS. Characters 9 and 10 

(Table 5) of ithe front panel setup siring define the remaining settings 

not defined by the other 8 characters. Table 5 shows setup state con- 
trolled by each bit. The only 2-bit setting is for Acquisition MODE. 
From our example setup string, the last two characters are 1 and 2. 
The bit values for these are 0001 and 0010 respectively. The de- 
coding for the bit values of character 9 is: 


TIMEOUT OFF Is enabled, 

CH2 is selected to respond to the controls settings, 
It is not a recalled waveform, and 

It is a valid store, 


Character 10 (0010) decodes as follows: 


The Acquisition MODE (2 bits) is NORM, 
It is in STORE mode, and 
AUTO TRIGGER is not enabled. 


i, 
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Logical Front Panel Decoding Tables 


Tables 1 through 5 show how the 40 binary bits of the logical front 
panel hexadecimal bytes are encoded. The tables divide the coded 
number of the front panel setup into five groups of two characters 
each. Tables 1 and 2 are very similar in that the same data is encoded 
in each, with Table 1 for Channel 1 and Table 2 for Channel 2. 


Table 1 
Channel 1 Settings 





HEXADECIMAL BYTE 1 


CHARACTER 1 CHARACTER 2 


CHi CH 1 
CPLG VOLTS/DIV 
(2 bits) (4 bits) 


4 hh), —_——{—_—_—___ 
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Table 2 
Channel 2 Settings 


HEXADECIMAL BYTE 2 
CHARACTER 3 | CHARACTER 4 


I}v CH2 CH2 
NIA CPLG VOLTS/DIV 
VIR (2 bits) (4 bits) 


[x|x| x x] cpia [Hex] x x x x] wo 


orelo| o|o o| nc || o fo o 0 o| Smv 


EU aa OS Le 
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Table 3 
SEC/DIV and Misc. Settings 





HEXADECIMAL BYTE 3 





















CHARACTER 5 CHARACTER 6 


SEC/DIV (5 bits) 


GFR Oy 0} sf 30 | 





MIDIO |W[D> KO [OWN [DM joni 














DO 10 10 |jO /O |o 
— OlO 
i— |1©O 1O i 
eo CO j— IO 
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Table 4 
Trigger Position, Slope, Source and Mode Settings 





HEXADECIMAL BYTE 4 










CHARACTER 7 CHARACTER 8 







TRIG TRIG TRIG MODE 
POS SOURCE (3 bits) 
(2 bits) (2 bits) 








Table 5 
Acquisition Mode and Misc. Settings 


HEXADECIMAL BYTE 5 





CHAR10 





~ ACQ STORE AUTO 


MODE 


222 RS-232 Interface Guide 


RS-232 ERROR CODES 





r PC in terminal mode, 
el 0} yn th utput via the RS-232 inter- 
face may be read. There are two types of error structure. Status mes- 
sages are output inv a command error is detected; diagnostic 
error codes are output if errors occur during normal operation or when 
running the calibration routine. If there is no errors, ihe 222 responds 
with “READY;” when it is ready to respond to commands. 








ry Error Coc — 
Communication Error Codes 








reitumed when an error is detected in a 
CT Attire 4 i naar scl mmanrd 
STAtus 0001 Jnrecognized command 


STAtus 0002 
STAtus 0003 
STAtus 0004 
STAtus 0005 
STAtus 0006 
STAtus 0007 





STAtus 0008 ent i: eqt lired 

STAtus 0009 Communication task is busy 

STAtus 000A as command had bad 
checksum 

STAtus 000B Bad task name for message 

STAtus FFFF User pressed escape 


Diagnostic Error Codes 


If an error is detected in the oscilloscope during normal operation or 

Calibration, an error message is output to an external terminal via the 

RS-232 serial port. These error codes are formatted as follows: 
ERROR wxyy z2zzz 


where wxyy and 2zzz are 16-bit hexadecimal numbers representing 
the error message. 


14 
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8 = Calibration error 
F = Fatal system error 








the error code. The va ends onthe type of 
r } + the firct 
wW5 
Error type 0: 
Error code 09 = Trigger search error (auto level mode) 


Error type 2: 


Error code XX = The data that failed to program. The 
value of the second code group (zzzz) is the address that 
failed to program 


Error type 4: 


Error code 01 = Bad EEPROM checksum detected 


Error code 02 = Calibration needed. The following zzzz 
codes indicate which calibration routine needs to be 
done: 


0001 = Channel 1 offset/gain calibration 
0002 = Channel 2 offset/gain calibration 


0004 = Channel 1 offset dac calibration 
0008 = Channel 2 ofiset dac calibration 
0010 = Channel 1 trigger calibration 


15 
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0020 = Channel 2 trigger calibration 
0040 = External trigger calibration 
0080 = Clock delay calibration 


If the zzzz error code is FFFF, no calibration routines have 
been done since all the default values were loaded into 
the EEPROM (this seen only at the first factory 
Calibration). 


Error type 8: 


01 = Acquisition timeout error 

02 = Mid position search error 

03 = Mid position range error 

04 = Offset search error 

05 = Offset range error 

06 = Offset gain error 

07 = Gain range error 

08 = Gain search error 

09 = Trigger search error 

10 = Trigger offset range error 

11 = Trigger gain error 

12 = Trigger hysteresis error 

13 = External trigger offset range error 
14 = External trigger hysteresis error 
15 = Clock delay error 

16 = Acquisition delay error 


Error type F: 


00 = COP timeout error 

01 = Illegal opcode execution 

02 = Interrupt exception 

03 = Task exception 

04 = CME error (not implemented) 


= an additional 16-bit value the meaning of which 
depends on the first error word, Except for error type 2 and error 
type 4 where the zzzz codes are given, the zzzz values (though 
sent) have no useful meaning to the user. 


eS 





Error Code Decoding Examples 


Following are two error code examples of how wxyy and zzzz are 
decoded. 


ERROR 8105 03FF (seen as the result of running the CH 1 GAIN 
self calibration via ihe serial interface) 


w = 8 = Calibration error 

x = 1 = Channel 1 

yy = 05 = Offset range error 

zzzz = O3FF = The offset DAC value (out of range limit) 


ERROR 4002 0040 (seen on power up if the serial Interface is 
connected) 


w = 4 = EEPROM calibration constant area error 
xX = 0 = No specified channel 

yy = 02 = Calibration needed 

zzzz = 0040 = Extemal trigger calibration 
















